home *** CD-ROM | disk | FTP | other *** search
/ Ham Radio 2000 / Ham Radio 2000.iso / ham2000 / tcp_ip / gp / gppaint.doc < prev    next >
Text File  |  1992-04-18  |  10KB  |  243 lines
  1.  
  2.  GP-Paint (Icon-Editor für GP) v1.00 by Stefan Pfeiffer, DD9EP@DB0IZ, 17.4.92
  3.  
  4.                                 Dokumentation
  5.                                 =============
  6.  
  7.  
  8. 1. Inhalt
  9. =========
  10.  
  11.   1. Inhalt
  12.  
  13.   2. Einführung
  14.   
  15.   3. Definitionen, Haftung und Vertriebsform
  16.   
  17.   4. Start von GP-Paint
  18.     4.1. Start von GP-Paint ohne Parameter
  19.     4.2. Start von GP-Paint mit Parameter
  20.     4.3. Start von GP-Paint mit gesetzter Umgebungsvariable
  21.   
  22.   5. Der Bildschirm von GP-Paint
  23.     5.1. Das Icon-Bearbeitungs-Fenster
  24.     5.2. Das Icon-Übersichts-Fenster
  25.     5.3. Das Farb- und Befehls-Fenster
  26.  
  27.   6. Bedienung
  28.     6.1. Tastaturbedienung
  29.     6.2. Mausbedienung
  30.  
  31.   7. Historie
  32.  
  33.   8. Kontaktaufnahme
  34.  
  35. 2. Einführung
  36. =============
  37.  
  38.   GP-Paint ist ein Editor für die bei GP von DH1DAE mitgelieferten Icons,
  39.   die während der Programmbenutzung am unteren Rand des Bildschirms ange-
  40.   zeigt werden. Mit diesem Editor lassen sich diese Icons fast beliebig
  41.   verändern, außer in ihrer Größe. Man kann in allen 16 verfügbaren Farben
  42.   ganz neue Icons zeichnen, die alten Icons verfeinern oder nur die Farben
  43.   ändern, damit sie z.B. auf LCD-Bildschirmen besser sichtbar sind.
  44.   GP-Paint lässt sich sowohl mit Maus als auch mit Tastatur bedienen,
  45.   beide Bedienungsarten werden jeweils in den Kapiteln 6.1. und 6.2. be-
  46.   schrieben.
  47.   GP-Paint läuft ebenso wie GP selbst nur auf EGA- und VGA-Karten; Versionen
  48.   für andere Grafikkarten wird es NICHT geben.
  49.  
  50. 3. Definitionen, Haftung und Vertriebsform
  51. ==========================================
  52.  
  53.   Wenn in dieser Dokumentation die Bezeichnung "GP-Paint" auftaucht, so ist
  54.   damit immer das gesamte Programmpaket (Das Programm selbst, diese Doku-
  55.   mentation und eventuelle Zusatzdateien) gemeint; Ausnahmen von dieser
  56.   Regel werden besonders erwähnt.
  57.  
  58.   Der Autor kann für Schäden, die durch Benutzung seines Programms entstehen
  59.   NICHT haftbar gemacht werden, die Benutzung erfolgt also auf eigene Gefahr.
  60.   Dieses Programm ist nach bestem Wissen fehlerfrei und läuft auf meiner
  61.   Konfiguration fehlerfrei.
  62.  
  63.   GP-Paint ist Ham-Ware, d.h. alle Rechte an diesem Programm verbleiben bei
  64.   mir, ich erlaube nur die kostenlose Benutzung durch lizensierte Funk-
  65.   amateure. 
  66.   GP-Paint darf nicht verändert oder gepatcht werden. Eine Einspielung
  67.   in Telefon-BBS ist erlaubt, soweit diese Einspielung für lizensierte
  68.   Funkamateure erfolgt. GP-Paint darf nur kostendeckend (Diskettenkosten,
  69.   Arbeitsaufwand,Porto) weitergegeben werden, eine kommerzielle Vermarktung
  70.   ist verboten.
  71.  
  72. 4. Start von GP-Paint
  73. =====================
  74.  
  75.   Es gibt drei Möglichkeiten, GP-Paint zu starten:
  76.  
  77.   4.1 Start von GP-Paint ohne Parameter
  78.   =====================================
  79.  
  80.     Wenn GP-Paint ohne Parameter gestartet wird, so sucht GP-Paint die Datei
  81.     ICONS.GP im aktuellen Verzeichnis. Wenn sie nicht gefunden wird, gibt
  82.     GP-Paint eine Meldung aus und beendet sich.
  83.  
  84.   4.2. Start von GP-Paint mit Parameter
  85.   =====================================
  86.  
  87.     Wenn GP-Paint ein Kommandozeilenparameter angegeben wird, so sucht
  88.     GP-Paint im angegeben Verzeichnis nach der Datei ICONS.GP. Wird sie
  89.     nicht gefunden, gibt GP-Paint eine Meldung aus und beendet sich.
  90.  
  91.     Beispiel:
  92.       GPPAINT C:\GP\
  93.  
  94.     GP-Paint sucht bei diesem Beispiel also im Verzeichnis C:\GP\ nach der
  95.     Datei ICONS.GP. Es ist notwenig, daß der Pfad mit einem Rückstrich
  96.     '\' abgeschlossen wird, damit die Datei ICONS.GP gefunden wird.
  97.  
  98.   4.3. Start von GP-Paint mit gesetzter Umgebungsvariable
  99.   =======================================================
  100.  
  101.     Wenn die Umgebungsvariable "GPICONS" gesetzt ist, so wird in dem dort
  102.     angegeben Pfad nach der Datei ICONS.GP gesucht; wenn sie dort nicht
  103.     gefunden wird, so gibt GP-Paint eine Meldung aus und beendet sich.
  104.  
  105.     Beispiel:
  106.       SET GPICONS=C:\GP\
  107.       GPPAINT
  108.  
  109.     GP-Paint sucht in diesem Beispiel im Verzeichnis C:\GP\ nach der Datei
  110.     ICONS.GP. Auch hier ist es notwendig, daß der Pfad mit einem Rückstrich
  111.     abgeschlossen wird. Es ist eventuell auch zweckmässig, daß die
  112.     "SET GPICONS="-Anweisung in die AUTOEXEC.BAT übernommen wird.
  113.  
  114. 5. Der Bildschirm von GP-Paint
  115. ==============================
  116.  
  117.   Nachdem GP-Paint die Datei ICONS.GP gefunden und geladen hat, schaltet
  118.   es auf Grafikdarstellung um. Der Bildschirm, der danach aufgebaut wird,
  119.   besteht dabei aus 3 Teilen:
  120.  
  121.   5.1. Das Icon-Bearbeitungs-Fenster
  122.   ==================================
  123.  
  124.     Der größte Teil des Bildschirm wird vom Icon-Bearbeitungs-Fenster ein-
  125.     genommen. Es befindet sich in der linken oberen Ecke des Bildschirms.
  126.     In diesem Fenster wird das jeweils aktuelle Icon vergrössert dargestellt.
  127.     Wenn GP-Paint auf einer EGA-Karte läuft, wird um den Faktor 6 vergrössert,
  128.     auf VGA um den Faktor 7. Das heisst jedes Icon wird 6 bzw. 7 mal so groß 
  129.     dargestellt, wie es in Wirklichkeit ist. 
  130.     Außerdem befindet sich in der linken oberen Ecke ein kleines Quadrat; es 
  131.     stellt den Cursor für Tastaturbedienung dar, bei Mausbedienung wird es 
  132.     nicht benötigt.
  133.     Nach dem Start wird sofort das erste Icon (Connect-Icon) in diesem Fenster 
  134.     dargestellt.
  135.  
  136.   5.2. Das Icon-Übersichts-Fenster
  137.   ================================
  138.  
  139.     Das Icon-Übersichts-Fenster befindet sich am unteren Rand des Bildschirms
  140.     auf der linken Seite. In diesem Fenster werden alle 14 Icons von GP in
  141.     zwei Reihen von je 7 Icons gleichzeitig angezeigt. Das jeweils aktuelle
  142.     Icon wird durch einen roten Rahmen hervorgehoben.
  143.  
  144.   5.3. Das Befehls- und Farb-Fenster
  145.   ==================================
  146.  
  147.     Das Befehls- und Farb-Fenster befindet sich am rechten Rand des Bild-
  148.     schirms. In diesem Fenster werden die 16 verfügbaren Farben, die aktuelle
  149.     Farbe und die verfügbaren Befehle angezeigt.
  150.     Im oberen Teil dieses Fensters werden in einem 4 mal 4-Quadrat die 16
  151.     Farben dargestellt, die verwendet werden können; darunter wird in einem
  152.     großen Quadrat die aktuelle Farbe dargestellt. Im unteren Teil des
  153.     Fensters werden dann die einzelnen verfügbaren Befehle dargestellt.
  154.  
  155. 6. Bedienung
  156. ============
  157.  
  158.   GP-Paint kann sowohl mit Tastatur als auch mit Maus bedient werden, ich
  159.   empfehle aber die Mausbedienung, da diese komfortabler ist.
  160.  
  161.   6.1. Tastaturbedienung
  162.   =======================
  163.     
  164.     Mit folgenden Tasten kann GP-Paint bedient werden:
  165.  
  166.     '+': macht das nächste Icon im Icon-Übersichts-Fenster zum aktuellen
  167.          Icon, das dann im Icon-Bearbeitungs-Fenster dargestellt wird.
  168.  
  169.     '-': macht das vorhergehende Icon zum aktuellen Icon.
  170.  
  171.     PageDown: macht die nächste Farbe in der Farbtabelle zur aktuellen Farbe.
  172.  
  173.     PageUp: macht die vorhergehende Farbe in der Farbtabelle zur aktuellen
  174.             Farbe.
  175.  
  176.     Cursortasten: bewegt den Tastatur-Cursor (kleines Quadrat) in die ent-
  177.                   sprechende Richtung. Der Tastatur-Cursor kann das Icon-
  178.                   Bearbeitungs-Fenster nicht verlassen.
  179.  
  180.     Enter oder Space: färbt das Pixel, auf dem der Tastatur-Cursor steht, in
  181.                       der aktuellen Farbe ein.
  182.  
  183.     S oder s (Save): speichert die eventuell veränderten Icons in der Datei
  184.                      ab, aus der sie vorher gelesen wurden. Die alten Icons
  185.                      werden dabei überschrieben.
  186.                      Es erfolgt KEINE Sicherheitsabfrage!
  187.  
  188.     R oder r (Reset): Stellt die Icons wieder her, die zuvor geladen, oder
  189.                       gespeichert wurden. Dieser Befehl kann dazu verwendet
  190.                       werden, um schwere "Mal-Fehler" wieder auszubügeln.
  191.                       Es ist aber zu beachten, daß nach dem Speichern der
  192.                       Icons die alten Icons nicht wieder hergestellt werden
  193.                       können, sondern nur die, die gespeichert wurden.
  194.                       Es erfolgt KEINE Sicherheitsabfrage!
  195.  
  196.     I oder i (Info): Zeigt ein kleines Fenster an, in dem der Programmname,
  197.                      die Version, das Erstellungsdatum und der Autor genannt
  198.                      werden. Durch Druck auf eine beliebige Taste wird dieses
  199.                      Fenster wieder gelöscht. Ist nicht genug Speicher frei,
  200.                      um das Fenster darzustellen, passiert nichts.
  201.  
  202.     E, e oder ESCAPE (Exit): Beendet GP-Paint OHNE Sicherheitsabfrage. Auch 
  203.                              wenn die Icons vorher nicht gespeichert wurden,
  204.                              wird GP-Paint kommentarlos verlassen.
  205.  
  206.   6.2. Mausbedienung
  207.   ==================
  208.  
  209.     Die Mausbedienung ist die die bequemste, die GP-Paint anbietet.
  210.  
  211.     Wenn man auf ein vergrössertes Pixel im Icon-Bearbeitungs-Fenster klickt,
  212.     wird dieses Pixel in der aktuellen Farbe eingefärbt.
  213.     Klickt man auf eines der Icons im Icon-Übersichts-Fenster, so wird das
  214.     angeklickte Icon zum aktuellen Icon gemacht, das dann im Icon-
  215.     Bearbeitungs-Fenster angezeigt wird.
  216.     Durch das Anklicken einer Farbe aus der Farbtabelle im Farb- und Befehls-
  217.     Fenster wird diese Farbe zur aktuellen Farbe gemacht.
  218.     Wenn man eines der beschrifteten Rechtecke anklickt, die sich im Farb-
  219.     und Befehls-Fenster befinden, so wird der entsprechende Befehl aus-
  220.     geführt (siehe 6.1. Tastaturbedienung).
  221.     Das Info-Fenster wird durch das Betätigen einer beliebigen Maustaste
  222.     wieder entfernt.
  223.     Durch Druck auf die rechte Maustaste wird das Programm beendet.
  224.  
  225. 7. Historie
  226. ===========
  227.  
  228.   Siehe HISTORY.DOC.
  229.  
  230. 8. Kontaktaufnahme
  231. ==================
  232.  
  233.   Wer Kontakt bezüglich Fehlermeldungen oder Verbesserungsvorschlägen mit
  234.   mir aufnehmen will, schreibt bitte eine Nachricht an:
  235.  
  236.     DD9EP@DB0IZ.
  237.  
  238.  
  239.   Ansonsten viel Spass beim zeichnen, verändern oder veredeln!
  240.  
  241.  
  242.                                                 Stefan Pfeiffer, DD9EP@DB0IZ
  243.